Additions

svn path=/trunk/; revision=18295

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 235e1274558921b2bd624783a75997c7659aa2af..551104b22d1db390494b099c42f3eba094f47fe5 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2007-06-29  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkbuildable.sgml: Some additions
+
 Wed Jun 27 11:57:13 2007  Tim Janik  <timj@imendio.com>
 
        * gtk/tmpl/gtkmenu.sgml: fixed push_in description.

diff --git a/docs/reference/gtk/tmpl/gtkbuildable.sgml b/docs/reference/gtk/tmpl/gtkbuildable.sgml
index 47000e289d6ec4a6f012106a1137e3ebd44ca8dd..0778d003b17fe6fd5df75a7796f90f892705b6b0 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbuildable.sgml
+++ b/docs/reference/gtk/tmpl/gtkbuildable.sgml
@@ -2,17 +2,17 @@
 GtkBuildable
 
 <!-- ##### SECTION Short_Description ##### -->
-SHORT
+Interface for objects that can be built by GtkBuilder
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-LONG
+In order to allow construction from a XML UI description,
+an object class must implement the #GtkBuildable interface.
+The interface includes method for setting names and properties
+of objects, parsing custom tags, constructing child objects.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
-<para>
-SEE ALSO
-</para>
 
 <!-- ##### SECTION Stability_Level ##### -->
 
@@ -25,12 +25,20 @@ SEE ALSO
 
 <!-- ##### STRUCT GtkBuildableIface ##### -->
 <para>
-
+The #GtkBuildableIface interface contains method that are
+necessary to allow #GtkBuilder to construct an object from
+a XML UI description.
 </para>
 
-@g_iface: 
-@set_name: 
-@get_name: 
+@g_iface: the parent class
+@set_name: Stores the name attribute given in the XML UI description.
+  #GtkWidget maps this to the GtkWidget:name property, and 
+  gtk_buildable_set_name() has a fallback implementation that stores
+  the name as object data. Implement this method if your object
+  has some notion of "name" and it makes sense to map the XML name
+  attribute to it.
+@get_name: The getter corresponding to @set_name. Implement this
+  if you implement @set_name.
 @add_child: 
 @set_buildable_property: 
 @construct_child: